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1 Pl card — Introduction 


The Packet Interface (PI) card is a low-cost high-speed synchronous serial 
interface card for packet radio. It was designed for both end-users and switch hosts 
in a network requiring low to high speed access. It provides DMA support for 
the high-speed channel, and interrupt-driven support for a second low-to-medium 
speed channel. DMA support for the high-speed channel allows the host system 
to run additional interfaces, such as the built-in low-speed channel or asynch ports 
for slip, kiss, or nrs connections. An 8253-5 timer chip is used to further decrease 
the interrupt load, and to improve the timing resolution for better efficiency. The 
PI card was designed specifically to run with KA9Q NET and to deliver the full 
potential of the WA4DSY 56kbps modem. 


This document assumes that you have knowledge of the installation and use 
of the NET program (NOS version). 


2 Getting Started 


Hardware Installation 


Jumper Settings 


See Figure 1 for a diagram of jumper placement. 
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Open: WDOG 
Closed: None 


‘A’ Channel. 
(15-pin female) 


Norm Delayed 


O22>.4) 68 A CAE ‘B’ Channel. 


Timer Extern. (25-pin male) 
CTSB 
x 


3- 
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slelolslelg) [tlefeieie 


IRQ SEL DACK DRQ 


[e-e| = Factory Default 


Jumper Block Placement 


The card comes with jumpers preconfigured for IRQ 7, DMA channel | and 
/O addresses starting at 380h. In many cases these will not need to be changed, 
and you can skip to the next section. However, if your installation has special 
requirements, this section will tell you how to change interrupts, DMA channels, 
or I/O addresses for the card, and also about some special purpose jumpers. 


Pa 


IRQSELECT =* 


IRQ SELECT allows selection of the IRQ signal to be used. The numbers 2 
through 7 correspond to the IRQ line desired. Likely choices are IRQ2 on XT 
systems and IRQ5 on AT systems. IRQ3 and IRQ4 may be used if the system has 
no serial ports. IRQ7 is the default, since it is likely to be available on either the 
XT or AT systems. Although it is nominally assigned to parallel ports, printer I/O 
does not generally use interrupts. However, many parallel port boards do have an 
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output for IRQ7, and it may be necesssary to move a jumper or cut a track on the 
parallel board in order to avoid conflicts with the PI board’s use of this interrupt. 


DACK and DRQ. - 2% 


DACK and DRQ are used to select the desired DMA channel. This is usually 
channel 1. Both jumpers must be set to the same channel number. 


_ 


3-X 390 W 


The I/O space decoding is set by this jumper block. See the section on the 
memory map for an explanation. This is usually set to position 8 (address 380h). 


BTS A od fe. 


This determines whether the RTS line will have an open-collector or TTL 
output. The default is open collector. 


RTSA 3. oN 


This jumper can be used to defeat the transmit watchdog circuit for the A 
channel. It is normally left open. The B channel does not have a watchdog circuit. 


This jumper selects between a normal I/O write signal and a delayed I/O write 
pi for the 8530. It must always be in the delayed I/O write position, unless 
an 85C30 is used (even then, there is really no reason to change it). 


CTSB A ie 


This jumper selects the source of the CTS signal for the B channel. This 
can come from the CTS input on the connector, or from the timer chip. If the 
B channel is being used as a synchronous port (the normal case), it should come 
from the timer chip. This jumper was included in case someone, someday, decides 
he wants to write an asynchronous driver for this port. 
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Connections 
The A port 


The A port has DMA support for high speed operation. It is the DB15 female 
connector. The pinout is as follows: 


Pin 1—PTT. 

This is an open-collector “push-to-talk” output. It can withstand about 30 
volts. It is intended to be used to key a transverter, but it has no current-limiting. 
The associated transverter must therefore limit current to about 150 milliamps. 


Pin 2 —RXC Reccive clock. 


This is a TTL-level input from the modem. 


Pin 3 —RXD Receive data. 


This is a TTL-level input from the modem. 


Pin 4 —TXC Transmit clock. 
This is a TTL-level input when the port is configured for external clocking 
(see the attach command). 


Pin 5 —DCD Data carrier detect input. 


This is a TTL-level input that receives carrier detect from the modem. 


Pin 6 —TXD Transmit data output. 


This TYL-level output provides transmit data to the modem. 


Pin 7 —RTS Request to send. 

This line can be configured to provide TTL levels or open-collector output. It 
is usually set to open-collector output when driving a WA4DSY modem, because 
this prevents a conunuous transmit condition when your computer is turned off. 


Pins 9 through 14 
These pins provide GND. 


1990-11-17 4 


PI User’s Guide 
) The B port 


We tried to keep your options open here. It is possible to configure this port 
for TTL or RS232 levels. To obtain RS232 level inputs and outputs, you need 
to stuff a Motorola MC145406 into the U12 position. (Watch the orientation of 
the chip.) To obtain TTL levels, you need to install jumpers or a dip header with 
the following connections: pin 2 to 15, pin 3 to 14, pin 4 to 13, pin 5 to 12, 
pin 6 to 11, pin 7 to 10. 


The software provided supports operation as an interrupt-driven synchronous 
port. It may be possible for some enterprising individual to write software to 
configure it as an async port. (A better approach might be to use a separate serial 
card with NS16550A chips installed. The interrupt latency could otherwise be 
a problem.) 


The connector for the B port is the DB25 male. The pinout is as follows: 


- Pin 1 —GND 
« Pin’? ==TXD 
Se PIs aks TT) 
SRT ig; eee tas 

Soe EU oD gmed 1S 

» Pin 7 —GND 
- Pin 8 —DCD 


- Pin 20 —DTR 


Memory Map 

The base address of the card may be set to 300h, 320h, 340h, 360h, 380h, 
)3A0h, 3COh, or 3EOh. These correspond to positions 0 through E on the jumper 
‘block. The offsets of the registers from the base address are: 


- 0 — B channel control register 
> 1 — B channel data register 
> 2-— A channel contro] register 
- 3— A channel data register 


> 4 — DREQ mask register. bitO=DREQ mask control 
- $8 — Timer 0 register A 
> 99 — Timer 1 register A 
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3 Software Configuration 


The attach command 


The NET program must be made aware of the card through the use of the 
attach command. The syntax of this command is: 


attach pi //O-address DMA-chn IRQ mode name bufsiz mtu 

speed-A speed-B [IP-address-A] [1IP-address-B] 

The parameters for //O-address, DMA-chn and IRQ must correspond to the 
jumper settings. 


The mode must be set to ax25 as that is the only mode the PI card currently 
supports. 


6c? 


The name parameter will be modified by appending an “a” or a “b” to 
distinguish the high speed (A) chanel from the low speed (B) channel. For 
example, “pi0” would result in two interfaces, one called “pi0a”, the other called 
“pi0b”. 

The bufsiz parameter specifies the size, in bytes, of the receive buffer used 
by the driver. 

The mtu parameter specifies the largest packet, in bytes, that the driver should 
transmit. 

The speed-x parameter is the speed of the corresponding channel in bits per 
second. If you specify O for either of these parameters, the card will be configured 
for external clocking on the corresponding channel. 

The /P-address parameters are optional. If they aren’t specified, the IP 
addresses of the corresponding channels will be set to whatever the system-default 
IP address is. 

Here is an example attach pi command for a WA4DSY modem running 
at S6kbps (which provides its own clocking), and a secondary channel with a 
1200bps modem with clock supplied by the PI card. 

attach pi 380 1 7 ax25 pid 2048 1024 0 1200 hs.ve3jf bbs.ve3jf 

RA 


The param command 


This command allows you to set various operational parameters. The syntax 
of this command is: 


1990-11-17 6 


PI User’s Guide 


param interface parameter-number value 

Using the previous example, entering: 

param pi0a 0 15 

would set parameter 0 for the interface name pi0a to a value of 15. 


In the following table, all time parameters are in units of 1 millisecond for 
the A channel, and units of 10 milliseconds for the B channel: 


param 0 —TXDELAY on 


This sets the ume from transmitter keyup until data are sent. HDLC flags 
are sent during this ime. The default for the A channel is 15 (15 ins) and the 
default for the B channel is 30 (300 ms). 


param | —P-persistence 


This sets the probability that a transmission will be attempted when the 
channel is free and data are available. Setting it to 64, for example, will give a 
64/255 probability. Setting it to 255 will defeat P-persistence. The default setting 
for this parameter is 128, giving a 50% probability. 


param 2 —Slot time 


This determines the amount of time that will pass before a transmission which 
has been deferred due to P-persistence will be attempted again. The default setting 
for the A channel is 15 ms, for the B channel 300 ms. 


param 3 —Tail time 


This determines the amount of tume the transmitter will remain keyed after a 
packet has been sent. Because this ume is measured from the time that the CRC 
has been sent, it must be long enough to allow the closing flag to be sent. The 
default for the A channel is 1 (1 ms) and for the B channel 3 (30 ms). 
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The pistatus command 


This command displays a summary of statistics about the PI card. These 
include (in order of presentation): 

The number of receive, transmit, and external interrupts, frames enqueued for 
transmission, frames received correctly, frames received with CRC errors, receive 
FIFO overruns, number of transmit underruns. 

There are some apparent anomalies in the status display which are actually 
normal and do not mean that there is a problem with the card or the software: 

The transmit interrupt count will remain at zero for the A channel, because 
DMA operation does not make use of transmit interrupts. It is quite normal 
for the Crcerr and RxOvrs counts to accumulate. These conditions are typically 
generated by the noise bursts received at the end of a transmission. Transmit 
underruns should be a fairly rare occurrence, however. Finally, after the card has 
been running for a while, some of the statistics may wrap around to zero, and 
show negative numbers. This is because they are stored in short integers by the 
driver software. 


4 Error Messages 


The PI card driver will generate error messages under certain failure condi- 
tions. They are: 


PI: ERROR - DMA page boundary violation 
This 1s an internal error. 
PI: Mode string unknown for interface string 


The attach command will generate this error if any mode other than ax25 
is specified. 


PI: Interface string already exists 
The interface name chosen is not unique. 


1990-11-17 


lo) 


PI User’s Guide 


E PI: Set mycall first 
Generated by the attach command if ax25 mycall has not yet been set. 
PI: Only 1 PI card supported 
The software allows for only one card per system. 
PI: IRQ # out of range 


An invalid IRQ number has been used in the attach command 


PI: No IP address 


No IP address has been supplied to the attach command for one or both 
channels, and there is no default. 


PI: No memory available for receive buffers 
Memory is so low that the attach command has failed. 
PI: No memory available for transmit buffer 
Memory is so low that the attach command has failed. 
>” Insufficient parameters 
The param command has been supplied an insufficient number of parameters. 
PI: Parameter string out of range 


The param command has been issued with an invalid parameter. 
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5S Bug Reports 


If you think you have found a bug, please document it with a full description 
of the circumstances and report it to: 


barry@dgbt.doc.ca 


Or to: Packet Working Group 
Ottawa Amateur Radio Club 
P.O. Box 8873 
Ottawa, ON 
KlGaais 


Include a description of your hardware setup, software version, and the 
conditions or actions which led up to your problem. 


Updates 


Software updates may be made available from time to time. A fee of $5 is 
currently charged, to cover the costs of providing this service. 


Updates may also be made available via anonymous FTP from sites to be 
announced. 


6 Limited Warranty 


The PI board is warranted to be free of defects in materials and workmanship 
for a period of thirty (30) days from the date of purchase. In the event of 
notification within the warranty period of defects in materials or workmanship, 
the seller will, upon return of the product, repair or replace (at its option) the 
defective parts. The remedy for breach of this warranty shall be limited to repair or 
replacement and shall not encompass any other damages, including but not limited 
to loss of profits, special, incidental, consequential or other similar claims. This 
warranty does not cover any damages due to accident, misuse, abuse or negligence 
on the part of the purchaser. This warranty does not cover other equipment or 
components that a customer uses in conjunction with this product. 
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q THE SELLER SPECIFICALLY DISCLAIMS ALL OTHER WAR- 
RANTIES, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED 
TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
FOR A PARTICULAR PURPOSE. Some states do not allow the limitation or 
exclusion of liability for incidental or consequential damages, or the exclusion 
of implied warranties, so the above limitations and exclusions inay not apply to 
you. This warranty gives you specific legal rights and you may also have other 
rights which vary from state to state. 
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7 Appendices 


Appendix A — Hardware description 


The PI card uses a Z8530 dual port Serial Communications Controller (SCC). 
This chip has been described as the Swiss army knife of serial chips. It does 
require a bit of glue logic to interface it to the ISA bus, however. UI is a 
bidirectional bus buffer used to meet the loading and drive requirements of the 
bus. U4 and U11-F provide buffering of additional bus signals. U9 and US-A 
and -D are used to delay the leading edge of the buffered I/O write signal for the 
28530. This is necessary to meet the timing requirements of the NMOS version 
of this chip. U3, a 74LS138, and the 16L8 PAL, U2, provide all address and chip 
select decoding. U6-A and US-D provide a means of masking DMA requests 
independent of the internal registers of the Z8530. 


The 8253 timer, U8, provides an independent timer for cach serial channel. 
One timer in this chip is used as the prescaler for the remaining two. The timer 
outputs are connected to the CTS pin of each serial channel. In this way, the CTS 
interrupts can be used to time events. U10 provides a divide by 32 function for 
baud rate generation for the B channel. This was included so that it will be possible 
to write a full duplex interrupt driver for the B channel. There is no divider for 
the A channel, because it is primarily intended to be externally clocked (by the 
WA4DSY modem), and because the DMA support for this channel is half-duplex. 


There is a transmit watchdog circuit for the A channel, conststng mainly of 
U11-B, C2, and R4. If RTS is asserted for more than approximately 10 seconds, 
the circuit will disable transmit. Q1 provides an open collector output for keying 
a transverter. Q2 can also be used to give an open collector output for the RTS 
line. This is intended to drive the WA4DSY modem, which has a pullup resistor 
on this line, to prevent keying the transmitter when the host computer is turned 
off. U11-A, -B, and -C are the clock oscillator and buffer for driving the Z8530 at 
3.68 MHz. The tmer chip is driven at half this frequency by U6-B. Position U12 
can either be jumpered across to provide TTL level signals to the B channel, or it 
can be stuffed with a Motorola MC145406 RS232 transceiver chip (not included). 
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